~~Installation/Basic Information~~

Put the catalogue files in the catalogue folder, the agents in the My Agents folder, and the .wavs in the Sounds folder. Also put this readme somewhere safe.

The Sound Emitter is actually two agents in one: a sound emitter that plays what ever sound you type and a console that creates and controls if the emitters are shown or hidden. The sound emitters are fairly simple, you can turn the sound off or on and change how frequently the sound plays between 5, 10, and 15 seconds. The orange button will delete the sound emitter and will clone the emitter when control is held down. You create them, so I call them the Created Sound Emitters.

The console is also fairly easy to use. The button on the left toggles if all sound emitters are visible or not. The middle part is where you enter the name of the sound you want the next sound emitter to play. I should probably mention that it only accepts four letters. No more, no less. The last part is what actually created the created sound emitters. If the sound you chose for it isn't in the sounds folder, the sound emitter with throw an error about a missing sound or get autokilled/suddenly disappear. Sadly, there's nothing I can do about that.

Then there's the Sound Emitters with customizable sounds, the custom sound emitters. They work like the regular sound emitters but they don't have a looping function. Also they aren't created with the console. Instead it pulls it's sounds from the custom sounds catalogue. There are three custom sound emitters and three lists the emitters pull from. Instead of playing a single sound, it plays a random one from the list. 

Customizing the custom sound emitters is fairly easy. Just type in the name of your sound in the catalogue file and save it. You can even do it while the game is running. To get your existing sound emitters to recognized new sounds, you either have to reload the game or hold down shift and press the orange button on any custom sound emitter. If you hear a noise, then it's refreshing all of the sound emitters. To get more then one of the custom sound emitters, just control click on the custom emitter's orange button.

~~Customizing the Custom Sounds catalogue~~

Each emitter only plays sounds for it's group and not any sounds in another group. So you have three to choose from. Just find the sounds you want, place them in the sounds folder, and then add their names to the lists. Be sure to only add the name of the sound and not the file type. Say you wanted to add "meow.wav" to the sound emitter. You would only add "meow" and not the whole file name. Like regular sound emitters, it only accepts four characters. Just like the regular emitters, these custom emitters will either get autokilled/suddenly disappear or throw an "missing sound" error if the sound you added isn't in the sounds folder. Also the sound emitter only accepts the first 10 sounds. Any sounds after that will be ignored.

And feel free to upload your customized sound list and sounds if you want. After all, I coded it to do that for a reason.

~~Credits/Other~~

Doringo - sprites and bug testing
KittyTikara - coding

If there is a bug, either send an email to KittyTikara@yahoo.com or pm KittyTikara on Creatures Caves and I'll fix it. If Creatures Caves goes down, feel free to reupload this agent as long as the readme is included. You are also free to modify this agent for learning purposes and create other agents based on the coding.